Deep linking is a mechanism for launching an app with a URI. This URI contains scheme, host, and path, and opens the app to a specific screen.

A app link is a type of deep link that uses http or https and is exclusive to Android devices.

Setting up app links requires one to own a web domain. Otherwise, consider using Firebase Hosting or GitHub Pages as a temporary solution.

Write a Flutter app that can handle an incoming URL. This example uses the go_router package to handle the routing. The Flutter team maintains the go_router package. It provides a simple API to handle complex routing scenarios.

To create a new application, type flutter create .

To include go_router package in your app, add a dependency for go_router in the pubspec.yaml file.

To handle the routing, create a GoRouter object in the main.dart file:

Add the following metadata tag and intent filter inside the tag with .MainActivity

Replace example.com with your own web domain.

提示 The metadata tag flutter_deeplinking_enabled opts into Flutter’s default deeplink handler. If you are using the third-party plugins, such as uni_links, setting this metadata tag will break these plugins. Omit this metadata tag if you prefer to use third-party plugins.

Host an assetlinks.json file in using a web server with a domain that you own. This file tells the mobile browser which Android application to open instead of the browser. To create the file, get the package name of the Flutter app you created in the previous step and the sha256 fingerprint of the signing key you will be using to build the APK.

Locate the package name in AndroidManifest.xml, the package property under tag. Package names are usually in the format of com.example.*.

Process may differ depending on the way apk is signed.

You can find the sha256 fingerprint directly from play developer console. Open your app in the play console, under Release> Setup > App Integrity> App Signing tab

If you are storing the key locally, you can generate sha256 using the following command.

The hosted file should look similar to this:

Set the package_name value to your Android application ID.

Set sha256_cert_fingerprints to the value you got from the previous step.

Host the file at a URL that resembles the following: /.well-known/assetlinks.json

Verify that your browser can access this file.

You can use a real device or the Emulator to test a app link, but first make sure you have executed flutter run at least once on the devices. This ensures that the Flutter application is installed.

To test only the app setup, use the adb command:

提示 This does not test whether the web files are hosted correctly, the command launches the app even if web files are not presented.

To test both web and app setup, you need to click on a link directly through web browser or other apps. One way is to create a Google Doc, add the link, and tap on it.

If everything is set up correctly, the Flutter application launches and displays the details screen:

Source code: deeplink_cookbook